home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / nr305.zip / NEWSROOM.DOC < prev    next >
Text File  |  1993-01-17  |  18KB  |  1,060 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                                       NewsRoom
  32.                 News Creation and Maintenance Utility for BBS SysOps
  33.  
  34.  
  35.                               (A product of LMD Group)
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.           NewsRoom version 3.05
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.                                       Chapter 1Chapter 1
  113.  
  114.                                     IntroductionIntroduction
  115.  
  116.  
  117.                NewsRoom is a utility intended for use by BBS SysOps to
  118.           create news files for their bulletin boards.  Although originally
  119.           designed to be used with PCBoard systems by using the PCB
  120.           specific color codes, NewsRoom also produces files with ANSI
  121.           color codes or plain ASCII text and also Wildcat! specific color
  122.           codes.
  123.                Each news entry created in NewsRoom is kept separate from
  124.           the others and may be re-edited at a later date if necessary.
  125.           Items are included in the end news product based on SysOp
  126.           selection.  Old news items may be deleted if they no longer
  127.           apply, either manually as the news is created, or based on date
  128.           criteria.  News files may also be generated in unattended (event)
  129.           processing.
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.           NewsRoom version 3.05
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.           NewsRoom version 3.05
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                                       Chapter 2Chapter 2
  241.  
  242.                                      Quick SetupQuick Setup
  243.  
  244.  
  245.                This is for those impatient folks who just hate reading
  246.           through long pieces of boring documentation (which we excel at
  247.           here).
  248.                To get up and running with NewsRoom, take the following
  249.           actions:  Unzip the file into a convenient directory.  It doesn't
  250.           have to be a special directory, and it doesn't have to be in the
  251.           path statement.  You must, however, execute NewsRoom from this
  252.           directory, since it isn't smart enough to find its configuration
  253.           files if started from elsewhere.
  254.                After unzipping the file, select the [F]ile |
  255.           C[o]nfiguration option and define at least one conference.
  256.           NewsRoom really likes having numbered conferences, so if your BBS
  257.           software wants something different, you'll have to adapt somehow.
  258.                Next, pop into the [C]onfiguration | [B]BS Common and set up
  259.           all of the nice things like your BBS name, Sysop name, date and
  260.           time formats, etc, etc, etc.
  261.                After this, you'll probably want to make a quick visit to
  262.           the [C]onfiguration | N[e]ws Colors to change over from the
  263.           standard light grey on black.
  264.                You are now ready to go into the [N]ews | News [M]anager
  265.           function to create a news file.  To do this, select this
  266.           function, then "press" the New button after highlighting a
  267.           desired conference.  If the dialog boxes that appear from this
  268.           point aren't intuitive, you'll probably have to make a quick
  269.           reference back to the appropriate spot in the documentation.
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.           NewsRoom version 3.05
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.           NewsRoom version 3.05
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.                                       Chapter 3Chapter 3
  369.  
  370.                                         FilesFiles
  371.  
  372.  
  373.                The Files menu selection allows for maintenance of the
  374.           conferences database.  The selection also has the Exit function
  375.           to leave NewsRoom.
  376.  
  377.  
  378.           3.1  Conference          3.1  Conference
  379.  
  380.  
  381.                On selecting the conference function, a dialog box will be
  382.           presented.  To add a new conference, you should select the Add
  383.           button from the bottom of the window.  Buttons also allow you to
  384.           select Next and Prev(ious) conferences to browse through your
  385.           conferences.  A conference may be deleted using the Delete
  386.           button.
  387.                When you are finished updating your conference database, you
  388.           may exit the dialog box by pressing the Escape key or clicking
  389.           with the mouse on the close button (upper left corner of the
  390.           box).
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.           NewsRoom version 3.05
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.           NewsRoom version 3.05
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.                                       Chapter 4Chapter 4
  497.  
  498.                                       ConfigureConfigure
  499.  
  500.  
  501.                This menu selection allows configuration of the BBS
  502.           displaying the news, the news colors, and the screen colors,
  503.           should they need to be changed.
  504.  
  505.  
  506.           4.1  BBS Common          4.1  BBS Common
  507.  
  508.  
  509.                This menu selection allows you to set up many common fields.
  510.           Most of the fields are self-explanatory, allowing you to select
  511.           the format for dates, times, and other fields.  A new addition to
  512.           this dialog box with version 3.04 is the ability to define an
  513.           external editor to create and edit news items.  In the provided
  514.           field, you should enter the complete path and filename of the
  515.           editor you wish to use.  If this field is left blank, the
  516.           internal editor supplied with NewsRoom will be used.
  517.                If you are using the external editor, version 3.05 added the
  518.           ability to designate what kind of swapping you want to use.
  519.           Please exercise caution here.  NewsRoom does no checking to
  520.           insure that you actually have XMS or EMS memory for swapping.  We
  521.           make the assumption (possibly faulty) that you know enough about
  522.           your machine to make this selection.  If you aren't sure, you
  523.           might be better off to use the Auto-detect feature.  This seems
  524.           to work fairly well.
  525.                Just a short word on using an external editor:  It is the
  526.           responsibility of the user to limit the margins on this editor to
  527.           sixty (60) columns (the same width as the internal editor uses).
  528.           If the editor margins are not correctly set, lines may be
  529.           arbitrarily split causing a less-than-pleasing effect in your
  530.           news files.
  531.  
  532.  
  533.           4.2  Colors          4.2  Colors
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.           NewsRoom version 3.05
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.           NewsRoom version 3.05
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.                                       Chapter 5Chapter 5
  625.  
  626.                                         NewsNews
  627.  
  628.  
  629.                This single selection now offers complete news management
  630.           services.  The first window presented will be a list of
  631.           conferences.  By using the buttons on the side of the window,
  632.           news for the highlighted conference may be created, edited, or
  633.           exported.  When finished with the news, the selection window(s)
  634.           may be closed by using the Escape key or the close button in the
  635.           upper left corner of the box.
  636.                CAUTION:  If you have not defined conferences using the
  637.           [F]ile | C[o]nference selection, do so BEFORE attempting to
  638.           create news files.  Failure to do so will cause NewsRoom to act
  639.           VERY erratically, and may even cause your system to come crashing
  640.           down about your ears.
  641.                By selecting the Edit function, a list of news items will be
  642.           presented in a new window for the highlighted conference.
  643.                If you activate the Add button, you will be allowed to add a
  644.           news item in the highlighted conference.
  645.                Selecting Edit in the Edit window will place the highlighted
  646.           news item into the editor, allowing updates.
  647.                Selecting Delete will cause the highlighted news item to be
  648.           deleted.
  649.  
  650.  
  651.           5.1  News Dialog          5.1  News Dialog
  652.  
  653.  
  654.                The dialog presented when the Edit or New functions are
  655.           selected will allow entry/editing of a news item.  Also, you will
  656.           see different dialogs depending on what options you set up in the
  657.           BBS Common dialog.  If you have defined an external editor, the
  658.           dialog shown will include only the Subject and Retain fields.
  659.           After filling in these two fields, the program will shell to an
  660.           external editor you have defined.
  661.                The subject field will accept a fifty character subject, but
  662.           will only display about 20 characters.  If the subject is longer
  663.           than the displayed length, it may be scrolled in either direction
  664.           to view the non-displayed portions.
  665.                The Retain field should only be used if special handling for
  666.           this news item is desired.  By leaving this field to zero, the
  667.           default retention (defined in the options) will be used to
  668.           determine when it will be purged by the automatic purge function.
  669.           An entry of -1 is a special indicator to NewsRoom that the item
  670.           should never be purged.
  671.  
  672.  
  673.  
  674.  
  675.           NewsRoom version 3.05
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.                If you have not defined an external editor, then the dialog
  683.           box you are using will include a rudimentary editor.  The editor
  684.           portion of the dialog is used to enter the news text.  At this
  685.           point, there is no word wrap available in the editor, so it is
  686.           the user's responsibility to insure that the lines are not wider
  687.           than the display field.
  688.  
  689.  
  690.           5.2  Event Processing          5.2  Event Processing
  691.  
  692.  
  693.                NewsRoom allows processing of news in an unattended manner.
  694.           You may use NewsRoom in a daily BBS Event to purge old news items
  695.           and create news files.  These activities are controlled by
  696.           command line switches.
  697.                Using the /p (or -p) switch will cause news items that have
  698.           expired to be deleted from the file.  This processing will affect
  699.           all news items in the database.
  700.                The /e (or -e) switch will create a new news file for each
  701.           conference with active news items.  Before creating new news
  702.           files, the files for all conferences will be deleted to insure
  703.           that there will be no news file if there are no active news
  704.           items.
  705.                If both switches are used (and this is permissible), the
  706.           purge will occur before the news export to insure that expired
  707.           items do not appear in the new news file.  The order of the
  708.           switches on the command line make no difference as to which
  709.           process comes first.
  710.                If you perchance happen to watch this process, you will see
  711.           nothing spectacular.  The NewsRoom main screen will appear, and a
  712.           message box  showing whether the program is purging or exporting
  713.           files will be shown.  To keep track of what happens in NewsRoom,
  714.           there is a log created by the event process.  Look in the file
  715.           NREVENT.PRC for a listing of news items deleted or problems that
  716.           occurred during the export process, or a list of news items
  717.           exported.
  718.                The deletion log entries will show the date the item was
  719.           created, the conference it was created in, the title, whether it
  720.           was purged or not, and if not, the date of scheduled purge.  In
  721.           the case of a news item with a -1 in the retention field, the
  722.           item will never be purged, and will show NEVER for the date of
  723.           scheduled purge.  The export entries show date of creation,
  724.           conference, and title.
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.           NewsRoom version 3.05
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.                                       Chapter 6Chapter 6
  753.  
  754.                                        SupportSupport
  755.  
  756.  
  757.                You can obtain support for newsroom from several areas.  The
  758.           best is LMD Group's support conference (Nr. 18) on the Brass
  759.           Cannon BBS.  Phone numbers are:
  760.  
  761.               o  (801) 226-8310 2400 baud MNP-5  (public access)
  762.  
  763.               o  (801) 226-8333 2400 baud v.42bis (public access)
  764.  
  765.               o  (801) 226-8315 14.4K USR Dual Standard (private)
  766.  
  767.                If you have not yet registered on The Brass Cannon, you must
  768.           do so on one of the 2400 baud lines.   You will be upgraded
  769.           within 24 hours and be given access to the private line.  Your
  770.           registration includes a a user account on this board.  If you
  771.           need support prior to registering, just call and log on.  Join
  772.           conference 18 and address questions to LMD GROUP SUPPORT.
  773.                Although not an official support area, the RIME network
  774.           Shareware conference (network conference #156) is monitored. Mail
  775.           may be sent to LMD GROUP SUPPORT and routed to ->BRASS.
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.           NewsRoom version 3.05
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.           NewsRoom version 3.05
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.                                      Appendix AAppendix A
  881.  
  882.                                  Program InformationProgram Information
  883.  
  884.  
  885.                NewsRoom was written specifically for BBS SysOps.
  886.           Since SysOps are, in our experience, more scrupulous
  887.           about registering their shareware, we take a markedly
  888.           different stance with  programs aimed at the SysOp
  889.           market than with other markets.  NewsRoom is in  no
  890.           way crippled.  Registering will take the "UNREGISTERED
  891.           DEMO" line out of your news and replace it with a line
  892.           indicating that it's registered, and do the same thing
  893.           with the main menu screen.  We don't ask you to trust
  894.           us that the program will work after registration, and
  895.           we don't put an expiration date on the program.
  896.                Please propagate our trust in you by registering
  897.           your copy of NewsRoom after you've tried it.
  898.  
  899.  
  900.           A.1  The Copyright          A.1  The Copyright
  901.  
  902.  
  903.               This software is the property of the LMD Group. As such,
  904.           users are granted a limited license for the use of this software.
  905.           Basically, you are allowed to use the software the same as a
  906.           book.  You are allowed to make archive copies of the software to
  907.           protect your investment.  By saying "as a book", this means that
  908.           any number of people may use the software, it my be moved from
  909.           CPU to CPU, but it may not be used at more than one location or
  910.           on more than a single computer at the same time unless a site
  911.           license is negotiated.
  912.               Along with that, goes a few other restrictions: You may not
  913.           decompile or reverse engineer the software.  You may not modify
  914.           the program's operation in any way.  The key file used by the
  915.           software is non-transferrable.  You may not sell or give away or
  916.           in any other way transfer a key file to another person without
  917.           express consent of LMD Group.
  918.  
  919.  
  920.           A.2  The Disclaimer          A.2  The Disclaimer
  921.  
  922.  
  923.                This software is not warranted to do anything but take up
  924.           valuable space on your disk, and possibly make you regret you
  925.           ever heard of it.  Any loss of income or productivity is not our
  926.           fault, although we will lend a sympathetic ear to such problems.
  927.  
  928.  
  929.  
  930.  
  931.           NewsRoom version 3.05
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.           A.3  The Acknowledgements          A.3  The Acknowledgements
  939.  
  940.  
  941.                We'd like to take a moment here and point out that PCBoard
  942.           is a product of Clark Development Company and is a registered
  943.           trademark.
  944.                Wildcat! is a product of Mustang Software.
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.           NewsRoom version 3.05
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.                                     ContentsContents
  1009.  
  1010.  
  1011.  
  1012.                Chapter 1  Introduction                               3
  1013.  
  1014.                Chapter 2  Quick Setup                                5
  1015.  
  1016.                Chapter 3  Files                                      7
  1017.                   3.1  Conference  . . . . . . . . . . . . . . . . . 7
  1018.  
  1019.                Chapter 4  Configure                                  9
  1020.                   4.1  BBS Common  . . . . . . . . . . . . . . . . . 9
  1021.                   4.2  Colors  . . . . . . . . . . . . . . . . . . . 9
  1022.  
  1023.                Chapter 5  News                                      11
  1024.                   5.1  News Dialog . . . . . . . . . . . . . . . .  11
  1025.                   5.2  Event Processing  . . . . . . . . . . . . .  12
  1026.  
  1027.                Chapter 6  Support                                   13
  1028.  
  1029.                Appendix A  Program Information                      15
  1030.                   A.1  The Copyright . . . . . . . . . . . . . . .  15
  1031.                   A.2  The Disclaimer  . . . . . . . . . . . . . .  15
  1032.                   A.3  The Acknowledgements  . . . . . . . . . . .  16
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.                                           i
  1060.